Dot yorum, özellikle Java programlama dilinde kullanılan, kod içerisine gömülü dokümantasyon stilidir. Bu yorumlar, kodun ne yaptığını, nasıl kullanıldığını ve hangi parametreleri aldığını açıklayan özel etiketler içerir. Javadoc olarak da bilinir. Bu sayede, kodun API dokümantasyonu otomatik olarak oluşturulabilir.
Özellikleri ve Kullanımı:
/** ... */
Şeklinde Yazılır: Dot yorumlar, normal çok satırlı yorumlardan farklı olarak, /**
ile başlar ve */
ile sona erer.@param
, @return
, @throws
, @author
, @version
gibi etiketler, dokümantasyonu zenginleştirmek ve yapılandırmak için kullanılır.Önemli Etiketler:
@param
: Metodun parametrelerini açıklar.@return
: Metodun geri dönüş değerini açıklar.@throws
: Metodun hangi istisnaları fırlatabileceğini açıklar.@author
: Kodun yazarını belirtir.@version
: Kodun versiyonunu belirtir.Javadoc
: Dot yorum olarak da bilinir. API dökümantasyonu oluşturma aracı.Ne Demek sitesindeki bilgiler kullanıcılar vasıtasıyla veya otomatik oluşturulmuştur. Buradaki bilgilerin doğru olduğu garanti edilmez. Düzeltilmesi gereken bilgi olduğunu düşünüyorsanız bizimle iletişime geçiniz. Her türlü görüş, destek ve önerileriniz için iletisim@nedemek.page